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Introduction 



Overview 

Mapmaker is an easy-to-use utility to help you create multiscreen displays using 
redefined, BASIC Graphics mode 2 characters. To create a map, you first define the 
dimensions of the total display area, and then you enter characters from the computer 
keyboard. Mapmaker acts as an easel upon which you can try out different combinations 
of shapes by displaying them on the screen. The program's fine scrolling feature allows 
smooth movement from one part of your map to another by using either a Joystick 
Controller or the directional arrows on the computer keyboard. Mapmaker comes with 
an all-purpose character set of map elements. However, you can use a separate 
character editor to create your own mapping characters and then produce an infinite 
variety of displays with Mapmaker. The program supports four character colors, plus a 
background color, and the package contains an easy-to-use facility for changing the 
playfield color registers. When you complete a map, the program saves your file on 
diskette. 

Required accessories 

• 32K RAM 

• ATARI 810 Disk Drive 

• ATARI BASIC Language Cartridge 

Optional accessories 

• Instedit (APX-10060 or APX-20060) or other compatible character set editor 

• One ATARI Joystick Controller 



Using Mapmaker with other programs 

Mapmaker is written in ATARI BASIC, with liberal use of machine language routines 
accessed by the USR function. In particular, Mapmaker uses page six of memory. 
Therefore, don't use Mapmaker with another program using page six. (If you're not 
familiar with the concept of pages in memory, you probably have nothing to worry about.) 
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Responding L tells the computer to scan the diskette for MAP files. If it finds just one, it 
loads the file automatically. If it finds two or more, the program asks you which file you 
want to load. 

Mapmaker then loads in your specified file and goes into EDIT mode. 

Responding C tells the computer to set up memory for a new map. The program asks 
you for the dimensions of the display area, measured in characters. Width can range 
from 22 to 1 28 characters and must be an even number (odd numbers are automatically 
rounded down). Height can range from 1 3 to 255 characters. The only other limitation on 
height is that it can't exceed a value which, when multiplied by width, equals more than 
4K (4096 bytes). On systems with 40K or more of computer memory, the maximum 
display area is 8K (81 92 bytes). The computer will substitute legal values for any values 
entered that aren't within the acceptable ranges. If these legal values aren't adequate for 
your purposes, reconsider the layout of your map project. 

Upon receiving the display dimensions, the program switches to the display and draws a 
border around it. Mapmaker loads in the scrolling routine from diskette and then goes 
into EDIT mode. 
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Demonstrating Mapmaker 



Loading in the demonstration map 

Be sure you duplicate all the Mapmaker files onto another diskette before proceeding. 
Then, following the instructions in "Getting Started" up to step 8, you should now be 
looking at the screen displaying the messages "PROGRAM INITIALIZATION" and 
"Create a new map, or Load an existing map?" At this point, press the "L" key to instruct 
Mapmaker to load a MAP file from diskette that demonstrates a map created with 
Mapmaker The program then automatically loads and displays the DEMO. MAP. The 
upper left corner of the map fills the screen, and the entire map is read into display areas 
not currently visible. Next, Mapmaker reads in a machine language file (named 
SCROLL.OBJ) containing the fine scrolling routine. A cursor is blinking in the upper left 
corner of the display. The lower right of the screen contains a set of X and Y coordinates 
and the status of the I (INVERSE video) flag, which is currently OFF. The current cursor 
coordinates are 0,0. 

Moving around the display 

First we'll move the cursor. If you want to use the Joystick Controller to move the cursor 
across the display, move the joystick in the direction of the desired cursor movement. Or, 
you can use the arrow keys (pressing the CTRL key isn't necessary) on the keyboard to 
move the cursor. The cursor shifts position at the same time that the cursor coordinates 
change to reflect the new location of the cursor. Don't move the cursor off the edge of the 
screen just now. 

You can turn the cursor off, and incidentally remove the readout in the lower right. Press 
the SELECT key. Now the display is "clean." This allows viewing without the distraction 
and clutter of the editing aids. 

Now, let's look at the whole map. Press and hold down the trigger button on the joystick, 
and pull the joystick toward you. This moves the screen "window" down the display. (You 
could also say that the display moves up. For scrolling, we always pay attention to the 
direction of window movement, not display movement.) To move the window under 
keyboard control, hold down the SHIFT key and press the down-arrow. Now, push the 
joystick to the right, or press the right-arrow to move the window to the right. You can 
move the window in any direction under joystick or keyboard control. This is called 
scrolling. The smooth movement of the window is called "fine" scrolling. The scrolling 
stops when the window arrives at the edge of the display. Examine the map. You're 
looking at a map of a mythical kingdom. With Mapmaker, you can make a map just like 
this. 
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Making a map 



Let's find out how it's done. Press the SELECT key again. Do you see the cursor? If it isn't 
on the screen already, it will be just outside the screen. Move the cursor until it appears 
on the edge of the screen. You may have noticed something else. The coordinate 
readout is now white. Press SELECT twice more; now it's black again. This black/white 
shift allows you to read the coordinates whether the background color is light or dark. 

As you move the cursor around, notice how the cursor highlights the shape of individual 
map characters. This points out how a map is a set of redefined characters placed side 
by side. The concept is quite simple once you get used to it. Instead of letters on the 
screen, we have map characterr — trees, rivers and mountains. The shapes are con- 
tained on a diskette file called ALLPRPS.SET, which loaded into the computer during 
PROGRAM INITIALIZATION. 

Now, let's see how these characters are put on the screen. Position the character in an 
open space. The cursor is now just a blinking square. Press the START key. The cursor 
stops blinking. Next, press the semicolon ( ; ) key. Voila! A tree. Press the START key 
again. The tree stops blinking. Now press the equal sign ( = ) key. Presto! Two 
mountains. Move the cursor away. The mountains remain, but they are blue. We want 
gold mountains, so position the cursor on the mountains and press the START key 
again. You see by now that this tells Mapmakeryou want to enter a new character at the 
cursor location. Before you press a key, press the ATARI logo key. Now press the V key. 
The I (INVERSE video) indicator says ON. Move the cursor away, and IShazam! the 
mountains are gold. That's all there is to it. Plug in characters at will. To remove those 
mountains, enter a blank character by pressing the space bar. To learn more about 
character sets and colors, read the sections titled "Character Sets" and "Color Regis- 
ters". 



The Mapmaker menu 

Let's look at some more Mapmaker features. Press the OPTION key to display the 
Mapmaker menu. We're back to the standard character set. The MENU contains six 
options. It also tells you how to use the MENU. You move the pointers by pressing 
SELECT. To choose an option, set the pointer on the option and press START Note that 
SELECT and START have different functions, depending on whether you're in EDIT 
mode or MENU mode. If you were to press START now, you would return to the map. Go 
ahead and press it to verify what happens. Now, press OPTION again to return to the 
MENU. 

Press SELECT a few times, so the pointers are on CHANGE COLOR REGISTERS. 
Then press START. Now you're looking at the color palette routine. The color in the large 
screen area is the color of register 1 . All the characters on the map that are this color are 
entered as register 1 characters. Press SELECT several times; as the text window 
indicates, this rotates the color registers. Next, we will change one of the colors. Select 
register B, the background color register. Right now, it's a rust orange. Let's make it 
white, so the map will look like winter. To change colors, we need to change both hue and 
intensity. 
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Changing hue 



To change the hue, you use either the joystick or the arrow keys (you need to use CTRL 

with the arrow key in this instance). Push the joystick left or right, or press the left-arrow I 

or right-arrow key. The color changes in the big window. Keep pushing the joystick or I 

pressing the arrow key until the gray color appears. I 

Changing intensity 

Now, change the intensity, which is the brightness of the color. We are currently looking I 

at white, so a bright white is really white, while a dim white is gray, and a "dark" white is I 

black. To change the intensity, push the joystick forward or back, or use the up-arrow or | 

down-arrow. Get a nice bright white. Once you have it white, press OPTION to return to I 

the MENU and then press START to return to the map. The background is now white, a I 

field of snow. Or did you change the wrong register? Maybe you have snowy mountains I 

instead. Go ahead; experiment with the colors. You're getting used to using Mapmaker. I 

Changing character sets I 

After you've tried out the color changing routine, go back to the MENU and select the I 

CHANGE FONT option. In Mapmakeryou work from a set of 64 characters. However, to I 

make a complex display, we sometimes need more than 64 characters. The full charac- I 

ter set has room for 1 28 characters. You can swap to the second set of 64 by using the I 

CHANGE FONT option of the MENU. You still can't use more than one of the 64 1 

character subsets on any one line of the display, but skilled programmers can divide the I 

screen and use different sets at different map "latitudes." With CHANGE FONT, you can I 

swap the character base, or load an entirely new font of characters. This can make the I 

map look pretty strange. I 

Let's try it. Press START with the pointer on the CHANGE FONToption. Then, press the I 

U S" key for "swap". Now, return to EDIT mode. The map is no longer a map, but a field of I 
text characters. Go back to the MENU again. Now, we want to exit from Mapmaker 
briefly. Set the pointer on the QUIT option. Make it a practice never to leave Mapmaker 

except through the QUIT option. This time, we don't want to alter the demonstration file, j| 

and so we just QUIT. Now, press START and read the warning. This protects you from | 

losing a lot of work by accident later on. This time, we press START again, and the I 
program terminates after locking DEMO. MAP on the diskette. 




Demonstrating Mapmaker 7 




Creating a new map 



Let's look at how to initiate a new map. Type RUN and press RETURN. The program 
returns you to PROGRAM INITIALIZATION. This time, type "C" in response to the 
Create... Load prompt. The program requests the dimensions of your new map, width 
first. Choose any even width between 22 and 128 (Mapmaker automatically rounds an 
odd number down by 1 ) and press RETURN. Using an even number is a requirement of 
the fine scrolling routine. Now choose the height; the range can be from 13 to 255. 
However, width times height cannot exceed either 4K (4096) on a 32K system, or 8K 
(81 92) on a 40K system. If you pick a height that is too large, MapmakerW\\\ correct your 
number to an acceptable one. 

After entering height, Mapmaker starts creating your map display by laying out the 
workspace. It draws a border around your map area, and assigns a set of default colors 
to the color registers. ("Default" just means that these are the standard colors. Black is 
the ATARI default background color.) You can check these colors through the color 
palette routine. After drawing the border, you are ready to edit. Go to it. You've already 
done some editing. An appendix contains a complete listing of the all-purpose 
(ALLPRPS) character set. Read the sections titled "Character Sets" and "Color Regis- 
ters" to understand better how to use the characters. 

Saving a map 

To save your handiwork, go to the MENU and select the SAVE option. This will write your 
map to the diskette. Next time you run Mapmaker, you can recall your map for further 
editing, or for just showing off. It will be named FILE1 .MAP on the diskette. The section 
on the MENU options tells you more about saving maps. 

Be sure to read the rest of the manual before getting too far into using Mapmaker. It's full 
of useful information. 
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Using Mapmaker 



Anyone who has experimented with the extensive graphics capabilities of the ATARI 
Computer is familiar with its high-resolution, multicolor graphics mode. Using this mode, 
a programmer can draw quite detailed pictures as long as he or she is willing to plot out 
the graphics commands needed to produce an elaborate display. Various hardware and 
software aids are available to help non-professional users create impressive hi-res 
screen displays. No matter what assistance is obtained from these products, however, 
hi-res displays are significant consumers of computer memory. A single screen of 
GRAPHICS 7 display requires about 4K of memory. While this is not too taxing for a 
BASIC program run on a 40K, disk-based system, few programmers are satisfied with a 
single hi-res picture. The alternatives for adding additional displays are either frequent 
disk access or significant additional memory commitment. 

A much more serious problem arises for programmers wanting to create and use a 
multiscreen display with viewing of the display through scrolling. At 3200 bytes per 
screen, a modest ten-screen display leaves no room for program logic. Obviously, this 
situation is unacceptable. Fortunately for ATARI Computer owners, the computer comes 
to the rescue with two advanced features that in combination make creating a hi-res, 
ten-screen display possible in just 2.4K of memory. These features are the five-color text 
modes and the ability of the ATARI Computer to use redefined character sets. 

Most users have seen displays using the larger multicolor text modes. In BASIC, these 
are the modes GRAPHICS 1 and 2. By using GRAPHICS 2, in particular, a single text 
character can fill an 8x8 pixel area of the screen. By redefining text characters so that 
they become portions of a picture or map display, a small allotment of screen memory 
can hold a truly impressive multiscreen display. Anyone who has seen the program 
Eastern Front (1941) can attest to the remarkable detail obtainable from a small amount 
of screen display memory. The multiscreen map, plus extensive game logic, of Eastern 
Front requires only 16K of memory. 

Mapmaker lets you make multiscreen displays using redefined GRAPHICS 2 charac- 
ters. Without Mapmaker, to create such a display, you'd have to arduously prepare a 
string of character names which, when displayed through an appropriate display list, 
would result in the desired map appearing on the screen. 

Mapmaker does not include a character set editor. There are a number of good text 
character editors on the market, including Instedit, available from APX. (See the section 
on "Character Sets" for a further discussion of character editors.) Mapmakehs equipped 
with an all-purpose mapping character set so that users without a character editor can 
still use the program. This character set is further described in the section titled 
"Character Sets". The map file included with the program demonstrates what can be 
done with Mapmaker using the all-purpose character set. 

Mapmaker was originally developed to facilitate the creation of maps to be used in 
simulations of historical conflicts, in other words, for wargames. Wargame designers 
using Mapmaker\N\\\ be encouraged to improve the quality of graphics in professionally 
designed simulation games. Whether you're a professional simulation game designer, 
or are simply interested in getting the most personal enjoyment out of your ATARI 
Computer, you'll find using Mapmaker a pleasurable and rewarding experience. 
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Program capabilities 



The standard dimensions of a GRAPHICS 2 full screen display (really GRAPHICS 2+1 6) 
is 20 characters wide by 12 lines high. The smallest display Mapmaker supports is a 
22x13 character display. This limitation is because the program uses a fine scrolling 
routine that cannot properly manage a single screen display. The limitation shouldn't be 
considered a liability, however. You'll quickly discover that a small display area gives you 
insufficient range for an interesting display. 

By comparison to the minimum display size, the maximum display supported by Map- 
makers truly awesome. The program makes up to 8K of memory available for screen 
display area. At 240 bytes per screen, 8K provides room for a single display comprising 
over 34 screens of total display area. Display width can vary from 22 to 1 28 characters; 
height can range from 1 3 to 255 character lines. The only limitations are that the product 
of width times height cannot exceed 8K (8192 bytes) and the width must be an even 
number (to simplify the fine scrolling routine). 

(If you have a 32K system, your maximum display area is limited to 4K of memory, rather 
than 8K. The full 8K is available only on systems with 40K or more of memory. However, 
a 4K area still leaves room for more than 17 screens of display.) 

GRAPHICS 2 is a five-color mode. That is, the characters can be any of four colors, and 
the background can be a fifth color. Mapmaker supplies a set of default colors (which 
differ from the standard ATARI default colors) and provides an easy-to-use facility for 
altering the "playfield" color registers to allow for any combination of five colors on the 
display. These color choices are stored with the diskette MAP file so that they are 
restored automatically upon recalling the map file. 

Your primary method of communicating with Mapmaker is through the keyboard. 
However, you can also use a joystick to control the display. The joystick provides for 
faster scrolling and cursor movement, particularly in diagonal motion. Other features 
include (1) the ability to swap character sets during editing, (2) a facility for accessing 
character editor programs directly from the Mapmakerprogram, (3) BREAK key disable- 
ment to protect against accidental loss of edit work, and (4) automatic file selection and 
naming. 

Creation of a multiscreen display is an unavoidably time-consuming task. Be prepared to 
spend several sessions creating a single display, and be prepared for a certain amount 
of tedious repetition entering characters for portions of displays, such as bodies of water. 
Clever choice of character shapes, as well as careful selection of field versus ground, will 
ease your task considerably. 

If you're not very familiar with the concept of a hi-res display created from redefined 
character sets, read the section titled "Understanding Redefined Text Displays" before 
using Mapmaker 
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EDIT mode 



General information 

You use EDIT mode to edit your displays. While in EDIT mode, you can move the display 
window and the cursor using either the joystick or the arrow keys on the keyboard. You 
can alter the character under the cursor through the keyboard. The OPTION, SELECT 
and START keys all have important functions in EDIT mode. 

Scrolling 

Mapmaker's ability to create multiscreen displays is useless unless you can view 
different portions of the display with ease. This is accomplished with a fine scrolling 
routine, which moves the screen across the display like a window. The routine is 
described in detail in the section titled "Fine Scrolling". To scroll the display, hold down 
the SHIFT key and press any of the four arrow keys. The window moves in the direction 
of the arrow pressed. For example, to see portions of the display below the bottom of the 
screen, use the down arrow. 

You can also scroll the display using a joystick. Press and hold the red trigger button on 
the joystick while pushing the joystick in the direction of desired window movement. You 
can scroll diagonally with a joystick, whereas you can't with the keyboard arrows. The 
display will not scroll past the borders which define the length and width of the display. 

The cursor 

When MapmakerWxsX goes into EDIT mode, the screen shows the upper left portion of 
the display. In the top left corner of the display, on the border, is a blinking cursor. The 
cursor keeps track of the current location of the character editor. In the lower right of the 
screen, the current coordinates of the cursor display. Starting from position 0,0 in the 
upper left, the X axis extends to the right along the width of the display. The Y axis runs 
down the screen matching the height of the display. As you move the cursor, the program 
constantly updates the coordinate information. The other information in the lower right 
concerns the status of the INVERSE flag. When this is OFF, character entry is in the 
colors of color registers 1 and 2. When the flag is ON, characters appear in the colors of 
registers 3 and 4. The flag flips each time you press the ATARI (INVERSE video) key 
prior to entering a new character onto the display. For more discussion of the INVERSE 
flag, see the section titled "Color Registers". 

You can move the cursor in several ways. You can move it by pressing an arrow key. 
Hold down an arrow key for repeated cursor movement. Or, you can move the cursor by 
pushing the joystick in the direction in which you want cursor movement. As with 
scrolling, you can move diagonally only through the joystick. The cursor also moves 
automatically under program control during scrolling. As the window is moved, the 
cursor remains in place. However, as the cursor disappears off the edge of the screen, it 
moves under program control so that it lurks about the edge of the display. This is 
indicated by the coordinates being updated during fine scrolling. When you finish 
scrolling, if the cursor isn't visible, a few cursor moves will bring it into view. Also, if you 
move the cursor off the screen, the cursor will move back to the screen as soon as you 
stop issuing cursor directions. 
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The cursor indicates the current location for character insertion onto the display. This is 
further discussed in the following section, "Character Editing." 

You can turn off the cursor to view the display without the distraction of a blinking cursor. 
Press the SELECT key to remove the cursor and the information display in the lower 
right of the screen. Press SELECT again to redisplay the cursor. The SELECT key also 
alters the "colors" of the coordinate data. Orginally displayed in black, the readout will 
display in white when the cursor is turned off and then turned on again. This is useful 
when you alter the background color from the default choice of white to a dark intensity 
color. Press SELECT twice more to redisplay the readout in black. 

Character editing 

You use the keyboard and the START key to enter and change characters on the display. 
Position the cursor at the location desired for a new character. Next, press the START 
key; the cursor stops blinking. Now press the key corresponding to the character 
desired. That character appears on the screen at the cursor location, and the cursor 
blinks again. The START key in EDIT mode signals to Mapmaker that the next key 
pressed should be translated into a character to be displayed at the current cursor 
location. You may press the ATARI key to change color registers after pressing the 
START key but before you press the key for the character. All keys are interpreted as 
characters, even RETURN, TAB, and SHIFT-CLEAR. The BREAK key is disabled. Any 
key you press is converted into characters. Therefore, you can't lose the display no 
matter what key you press (see the warning about the SYSTEM RESET key below, 
however). The keyboard is in lower case, so use the SHIFT key to enter uppercase 
characters. You can still use the CAPS-LOWR key to lock in upper case or the CON- 
TROL (CTRL) key when you need to enter a series of such characters. 

The SYSTEM RESET key has no? been disabled or reprogrammed. Never press this 
button while using Mapmaker, unless you're certain you don't wish to save your map- 
work. To exit the program, use the MENU. 

Exiting EDIT mode 

Use the OPTION key to leave EDIT mode and return to the MENU, where you can 
access Mapmaker's special functions. You can also return to EDIT mode from the 
MENU. The next section describes the MENU functions. 
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Mapmaker menu 



General information 

In addition to the ability to save and recall edited map files, Mapmaker contains several 
special functions, which you can access through the MENU. The options are described 
below. 



EDIT MAP 

Use this option to exit from the MENU and enter EDIT mode. The screen returns to the 
map display at the same location that was on the screen when you pressed the OPTION 
key. 

* 

CHANGE FONT 

Use this option to load a different character set file. Or, you can swap the character base 
from the uppercase/punctuation set to the lowercase/control character set, and back. The 
alternatives are displayed when you press START while the pointers are set on this 
option. The choices are to press U S" to swap the character base, or "L" to load a new 
font. Be sure that the diskette containing the font to be loaded is already in the drive 
before choosing the "L" option. If there are several character sets on the diskette, the 
program gives you a choice of files to load. After loading or swapping a character set, you 
return to the MENU. 



RUN FONT EDITOR 

This selection isn't active in this version of Mapmaker. Choosing this selection has no 
effect other than to reset the MENU pointer at EDIT MAP. It's included because the 
option to move back and forth quickly and easily between Mapmaker and a character 
editor program is often desirable when you're designing the characters as they're 
needed, rather than all at once before map editing commences. The option is inactive, in 
part, because its exact form depends on the character editor program in use, and in part 
because alterations are usually required in the editor program to optimize the rotation 
between it and Mapmaker. See the section titled "Character Sets" for further informa- 
tion. 



CHANGE COLOR REGISTERS 

Use this option to activate a mechanism for altering the colors in the five "playfield" color 
registers. The screen shows a split-screen display. The color of register 1 fills the upper 
area. In the lower text window are instructions for altering the registers. 
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You can vary both the hue and the intensity of colors, using either the keyboard or 
joystick. To change the hue, move the joystick right or left, or hold down the CTRL key 
and press the left-arrow or right-arrow. As the text window indicates, the first register 
displayed is register 1 . To select registers 2 - 4 or the background "B" register, press the 
SELECT key. The color of each register displays in turn. The colors selected apply only 
to the map display, but the changes are permanent, and are stored with the map file on 
diskette. You can alter them again by returning to this option. Press the OPTION key to 
return to the MENU. Instructions for using the color changing facility display in the text 
window. 



SAME MAP TO DISK 

Use this option to save your entire map on the diskette currently in drive 1 . Use SAVE 
often; it protects your work. The file will contain the values of the five color registers for 
the map at the time you select this option. Mapmaker includes an automatic file naming 
facility. If you're creating a new map display, Mapmaker assigns the name FILE1 .MAP to 
your map the first time you save it. If a file already exists on the diskette named 
FILE1 .MAP, Mapmaker overwrites it, unless it is currently locked. If Mapmaker encoun- 
ters such a locked file, the program names the new map file FILE2.MAP. Subsequent 
files are named FILE3.MAP, and so on. 

At PROGRAM INITIALIZATION time, if you're loading an existing MAP file, that file is 
unlocked, and Mapmakeruses that filename when you select the SAVE option. You may 
freely change filenames through the DOS menu. The only requirement is that the 
extender of the filename must be ".MAP" (for example, "USA.MAP"). The automatic 
filenaming facility is efficient and safe, but it requires you always to exit Mapmaker by 
way of the QUIT option. Never leave Mapmaker by pressing the SYSTEM RESET 
key. Once the MAP file has been saved, control returns to the MENU. You can return to 
EDIT mode or terminate the session using the QUIT option. See the section on MAP 
FILES for further information regarding the contents of saved files. 

QUIT 

Use this option to leave Mapmaker. Using QUIT right after using the SAVE option locks 
your MAP file before you exit the program. Otherwise, when you select QUIT, the 
program displays a warning that no SAVE has occurred since the last time you were in 
EDIT mode. If you forgot to save your display, press OPTION to return to the MENU. 
Otherwise, pressing START again locks any currently open MAP file and returns you to 
BASIC. 
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Technical information 



Understanding redefined text displays 

To understand the technique involved in creating a text-based, high-resolution display, 
you first need to understand the difference between a text mode and a bit-map mode. 
The computer generated display on the television screen is composed of many small 
dots, called "pixels" (for "picture element"). A given pixel appears as a dot of color on the 
screen, or as a gray or white dot. Screen displays are made up of patterns of these dots. 
A bit-map display uses computer memory to store the status of individual pixels using 
one or two bits of memory. Two-color, bit-map graphics modes use one bit per pixel ("on" 
or "off"), whereas four-color modes use two bits per pixel (to choose one of four colors). 
Although these modes let a single byte of memory store the color data for four or eight 
individual pixels, higher resolution displays can have thousands of pixels on the screen. 

Text modes, on the other hand, use relatively little screen memory, because each byte 
now names a text character. Individual text characters on the screen comprise an area of 
64 pixels (an 8x8 area); hence much less memory is needed to fill the screen. When 
operating in a text mode, the screen display system reads each byte of screen memory 
and uses the value found to locate an eight-byte shape in a table of character shapes. 
The 64 bits of this byte group describe the appearance of the text character on the 
screen. For example, Figure 1 shows the shape of the letter "R" in standard ATARI text 
format. 




Figure 1 " R " in standard ATARI text format 



The standard text character shape table is stored in a 1 K area of the 1 0K ROM Operating 
System. One byte in RAM, address 756 ($2F4 hex), and referred to as CHBAS, is a 
"pointer" to the table of text shapes. This means that location 756 contains the high byte 
of the two-byte address where the shape table begins. The shape table starts at location 
57344 ($E000) and so the value stored in location 756 is 224 ($E0), which is 57344 
divided by 256. If you were to change the address stored in CHBAS, you would be telling 
the computer to look elsewhere to find the shape table. This lets you create a table of 
alternate character shapes, store that table in a 1 K area of RAM, and tell the ATARI to 
use that set of shapes for displaying text on the screen. 

Suppose you've redefined the shape of the letter "R" to look like the shape in Figure 2. 
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Fisfure 2 Redefined " R " 



Now when you call for the letter "R" on the screen, you see in its place a tree. To create a 
forest on the screen, you would enter several R's in close contact. As characters are put 
on the screen, they stand shoulder to shoulder without visible gaps or seams. Standard 
characters maintain separation by not filling the entire 8x8 area they are allocated. In 
redefining text shapes, you can run right up to the borders of the character grid. Rivers 
and coastline are generated by making characters which meet at common locations on 
the edges of the character grid. Figure 3 shows two shapes of "North Coast" characters 
which, when placed side by side, display an irregular pattern of seacoast. 



Figure 3 North Coast Characters 



To accomplish the Mapmaker technique, you create a variant character set with sym- 
bolic and cartographic shapes, then load that shape table into RAM, point to it, and start 
plugging in characters in a multiscreen GRAPHICS 2 + 16 (i.e., full-screen) display. 
Mapmaker provides an all-purpose mapping character set (the file is named 
ALLPRPS.SET) for you to experiment with. However, the full power of Mapmaker comes 
into play when you use a character editor program to create your own redefined 
character set. 

Mapmakeruses GRAPHICS 2 for two reasons. First, GRAPHICS 1 and 2 are five-color 
modes, compared to GRAPHICS 0, which is only a 1 1 /2-color mode. Second, Mapmaker 
uses GRAPHICS 2 rather than 1 because GRAPHICS 2 characters appear square on 
the screen whereas GRAPHICS 1 characters appear rectangular. The GRAPHICS 2 
characters fill a larger area of screen per character, and thus use the least amount of 
memory per screen display. 

In GRAPHICS 2, only 64 of the 1 28 character shapes are available for use because two 
bits of the byte that stores the character "name" value are used to denote the color the 
character should be displayed in. The remaining six bits provide for a range of values 
from 0 to 63. Thus, a given map in Mapmaker \s limited to 64 different shapes. Usually, 
this is more than enough. 

For more information about redefined character sets, see the BIBLIOGRAPHY. A 
thorough understanding of this facet of the ATARI Computer's design is critical to optimal 
use of Mapmaker. 



16 Technical Information 



The magic ingredient in Mapmaker displays is the redefined character set. The section 
titled "Understanding Redefined Text Displays" briefly explains the technique. You can 
obtain more information from some of the literature mentioned in the BIBLIOGRAPHY 
This section addresses facets of redefined character sets of particular importance in 
using Mapmaker. 

You can't create new character sets with Mapmaker. For that you need a character set 
editor. Instedit, the character set editor available through APX, creates files with a 
filename extender of "SET" that Mapmaker accepts as character sets. Another good 
editor is Fontedit, which is part of IRIDIS #2, published by The Code Works. Mapmaker 
accepts files created by Fontedit. These use "FNT" as a filename extender. You may 
prefer yet another character editor. To be usable by Mapmaker, a character set file must 
have the following characteristics: 

1. The filename must have the extender "SET" or "FNT". 

2. The file must be a 1 K binary format file of character shapes in the same order as 
they appear in the ROM OS. 

When using a character set in large text graphics modes, only 64 characters of the 1 28 
character set are available since the one-byte character "name" must include the color 
register value for displaying that character. Two bits identify the color; the other six bits 
name the character. Mapmaker initializes with the uppercase/punctuation subset of the 
character set. When redefining a set, use this subset rather than the lowercase/control 
character subset. You may use the latter, provided you also use the CHANGE FONT 
option in the MENU to swap the character base. 

A blank font table is provided in the back of this manual to help you in creating new fonts. 
As you create characters, enter their descriptions into the appropriate areas of the table. 
You may make photocopies of this table for your personal use only. 

The table also indicates the keys corresponding to the uppercase/punctuation set for 
generating characters in registers 2 and 4. For example, "A" generates a character in 
color 1 , while "a" displays the same character in color 2. Of course, the same correspon- 
dence applies for registers 3 and 4. The difference is that the INVERSE flag must be ON 
to obtain registers 3 and 4. The status of the INVERSE flag is provided along with the 
cursor coordinate readout. 

When creating a new character set, a few guidelines should be followed. Virtually every 
character set needs a "fill" character and a "null" character. Mapmaker expects the first 
character in the set to be the "null" character, obtained by pressing the space bar. This is 
ASCII value 32 ($20) and internal value 0. This is the same as the standard character 
set. If you use the lowercase subset, you must redefine the CONTROL-COMMA 
character to be blank. Mapmaker also expects to find a "fill" character at ASCII 42 ($2A). 
This is value 1 0 ($0A) in internal code and it corresponds to the asterisk ( * ) character. 
The standard character set lacks a "fill" character, that is, a character with all 64 pixels 
"on". This corresponds to the inverse of a blank. The "*" was chosen because it's close 
to both the START key and the arrow keys. You'll find many occasions to enter multiple 
fill characters. Since the map border consists of register 4 fill characters, the automatic 
border drawing routine creates a useless edging if the "*" character isn't properly 
defined to be "fill." The other 62 characters can be any shapes you desire. 
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A disciplined approach to creating a new map begins with a plan for the colors and 
shapes you'll need to interpret the image you wish to display. Keep in mind that 64 
shapes are not really all that many. Avoid too many unique shapes and get as much use 
out of all 64 as possible. If you're using Instedit, you'll see the standard character set 
displayed in a table. Your first step will be to change the "*" character to a fill character, 
all pixels on. Then start constructing your other shapes by selecting each character in 
turn, reconfiguring it to suit your needs. Remember that you must use either the 
uppercase/punctuation half of the set or the lowercase/control character portion. With 
Instedit you can try out different character combinations as you create them. You can 
always go back and revise individual characters if they don't look quite right in your map, 
but you'll save some time by trying them out as you create them. 

After each character is edited, enter a description of the new character in the Character 
Set Table next to its corresponding key character. You can make photocopies of the 
table in the back of this manual to help you keep track of your character sets. 

The SAVE command in INSTEDIT is the proper method for storing your character set on 
diskette for Mapmaker's benefit. You can put several .SET files on a single diskette; 
MapmakerW\\\ give you a choice of files to load if it encounters more than one. 

The file ALLPRPS.SET is designed to be an all-purpose mapping font. It contains many 
standard mapping characters, and provides good examples of how irregular terrain can 
be created through artful character design. Note, for example, that all river characters 
terminate at the same point on corresponding sides of each character. Coastline can be 
varied by one pixel for its endpoints as this fits with the irregularity of the coast in any 
event. At least two characters of each type of terrain should be made to provide for 
variety and to enhance irregularity. For extended coastlines, four different characters 
provide a more authentic look. 

In sum, a map is only as good as its character set. The more creative your character set, 
the more original and appealing will be your map. Mapma/cerencourages experimenta- 
tion because it's so easy to use. 

Option 3: RUN FONT EDITOR 

In the description of the MENU, the third option, RUN FONT EDITOR, is inactive. 
Inquisitive users will discover that lines 7190 and 7195 of MAPMAKER.BAS contain 
REM lines with code for activating this MENU item. You can implement them by 
removing the REM's and inserting the name of your character editor program in line 
7195. If it were this easy, however, the choice would have been made active. In reality, 
the task is more difficult. Some modification will probably be necessary to your character 
set editor program before this transition works smoothly. The goal is to have the editor 
program come up with the current redefined font already accessible for further editing. 
The editor program should also provide a quick return to Mapmaker. The solution isn't in 
this manual. You'll need to devise the proper code for linking the two programs. 
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Color registers 

Careful selection of color mixtures is critical to an attractive display. Mapmaker uses 
BASIC'S GRAPHICS 2 mode to display characters. This is a five-color text mode, 
meaning that each character can be displayed in one of four colors against a background 
that can be a fifth color. A single character can't contain more than one color. There are 
other graphics modes in the ATARI Computer that do allow for multicolor text characters. 
Mapmaker doesn't currently support these other modes, however. This means that any 
one square of map area should not contain more than one map feature. If you want a 
river to wind through a forest, put tree characters next to the river charcters. The only way 
to put tree and river in the same character is to have them both the same color. If you like 
green rivers or blue trees, go ahead. Another problem with mixing features in a single 
character is that the character becomes too specialized. With only 64 characters in your 
palette, you have to get a lot of use out of almost all of them. Creating too many unique 
characters limits your display. 

Recall that the character "name" selects both character and color. This feature deserves 
more explanation. Each character on the screen corresponds to one byte in RAM. The 
position of those bytes determines the position of the characters in the display. In reality, 
the display is one-dimensional in RAM. If the display is, for example, 80 characters wide, 
then the first 80 bytes of display RAM hold the top row of the display, the next 80 bytes 
hold the next row, and so on. In each byte is a value corresponding to the character to be 
displayed. Suppose a particular byte is to display the "fill" character in the color of 
register 4. This is, in fact, what the display border is composed of. The byte will then hold 
this binary value: 1 1 001 01 0. The two high bits, 1 1 , designate the color. This is read as a 
binary value of 3 in decimal. A two-bit value can range from 0 to 3. For ease and clarity, 
we number the color registers 1 to 4, but internally they are numbered 0 to 3. Hence, 1 1 
binary refers to color register 4, i.e., the fourth of four. The other six bits "001010" are 
read as value 10 decimal, the internal code value for the "*" character, which we 
redefined as the "fill" character. Since six bits can range from 0 to 63, we can name 64 
characters in this graphics mode. So we see that the binary value "1 1001010" or 202 
decimal ($CA) "names" the "fill" character in color 4. 

Color mixing is a process of trial and error. The ATARI Computer has a lot of colors to 
choose from, in part so that you can obtain pleasing color combinations. Intensity of the 
different color registers plays a key role in color mixing. Too many dark colors make a 
dim, muddy display that doesn't show good contrast. Too many bright colors can be 
unpleasantly dazzling. The default colors were chosen to provide some basic shades 
that work acceptably well together. Your displays don't have to keep to these color 
choices. 

One guideline for selecting colors that makes mapping easier and lets Mapmakerwork 
better for you is as follows. Registers 1 and 3 should be of contrasting intensity, and the 
same for registers 2 and 4. You'll want to maintain some contrast anyway, and this 
scheme works better in Mapmaker because the cursor blinks by shifting colors between 
registers 1-3 and 2-4. If these colors are too similar, the cursor won't have enough 
contrast to provide a noticeable blink. If you have changed colors and find the cursor 
hard to spot, readjust the colors for more contrast. You can always change the colors 
again when you've completed the map. 
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One final note that applies to both characters and colors: as you create a map with 
Mapmaker, you are constructing a "field/ground" display. By this is meant that you're 
designating a background color and then overlaying shapes on the background in other 
colors. It's more usual to see the shapes as "field", that is, covering the background with 
their shape content. It's entirely possible, however, to create shapes from the "ground", 
that is, to outline the shapes, fill all the character area around the shape, and let the 
background color show through as the representation of the shape. While the more 
customary approach is recommended, certain maps may call for a field/ground reversal 
that could result in a stunning display. The point is not to let your imagination be bounded 
by what you've seen. There are many paths to orginality. 

Map files 

If you ever plan to do anything with the maps you create other than to revel in how clever 
they are, you must understand the structure of the files in which they are saved on 
diskette. The map data files must have the extender "MAP" in the filename. Mapmaker 
recognizes no other data file. The program also contains an automatic file naming 
system described earlier in this manual. 

When Mapmaker saves a display, it writes a diskette file, which contains three subele- 
ments. The first two bytes of the file are the width and height of the display in numbers of 
characters. These values are always less than 256 and thus are one byte in size. When a 
file is read in, these two values are used to determine the amount of display RAM 
required for the display. This is particularly critical considering that a display block cannot 
cross a 4K boundary in RAM, while Mapmaker displays can range up to 8K. 

The next five bytes on the file are the values of the five color registers, first the four text 
registers and then the background color. This enables Mapmaker to restore the color 
choices made during earlier editing sessions. The third and largest subsection of the file 
is the map data. This is written by the simple yet effective method of defining the entire 
display area in RAM as the buffer for a CIO call for disk output. I am indebted to the 
publication De Re ATARI for describing the function and use of the IOCB in relation to 
the multiple GET CHARACTERS function. This little subroutine string (CIO$) in Map- 
maker does yeoman service in quickly reading in font and map files and in writing out 
display data. Five simple POKEs and a USR call, and you can read or write any data file. 
Lines 8000-8080 in Mapmaker write the MAP file. If you can understand this, you can 
construct the necessary code to read the map into another program application. Making 
maps is fun, but using them in other programs is rewarding. Read De Re ATARI and 
examine Mapmaker, then write your own program around a map display of your own 
creation. That is what Mapmaker was really created for. 
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Face it, you really have to know something about assembly language to implement fine 
scrolling. This technique requires not only a wholesale modification (actually a complete 
rewrite) of the display list, but also the ability to update the entire display list during the 
course of a single vertical blank. Furthermore, my experiments with the fine scrolling 
registers suggest that trying to manipulate them with POKEs simply results in a jumpy, 
unstable screen display. In short, if you don't know a lot about display lists, USR routines 
and vertical blank interrupts, get someone to teach you before you try to implement fine 
scrolling. 

Assuming you are at ease with these subjects, the assembly listing of SCROLL.OBJ is 
provided for your information. It is read into the unused area of the player-missile 
graphics region, which physically resides just below the display area in Mapmaker. (You 
didn't realize Mapmaker has PM graphics? What do you think the cursor coordinate 
readout is?) Once read in, it is activated by a short USR routine in line 1 1 601 that resets 
the immediate vertical blank vector to the address of SCROLL. Henceforth, each time 
the screen is drawn, this routine is executed. It looks to see if the proper keyboard or 
joystick conditions exist to command scrolling, and if these are tripped, it executes the 
proper steps to accomplish the scrolling function. 

The assembly listing is pretty well documented. If you intend to use a map of your 
creation in another program, you'll have to use a routine similar to SCROLL to enable 
you to see the whole display. Note that SCROLL uses some page zero of RAM and also 
stores some values in page six. SCROLL used to live in page six. That was when it was 
only joystick-driven. When I added keyboard drive, it outgrew one page of RAM. I moved 
it, but the data addresses stuck. There is so much going on in Mapmaker anyway, what 
with vertical blank interrupts and multiple display lists, that I thought it best to ban any 
other routines from page six while Mapmaker was running. Note, by the way, that 
Mapmaker supports three separate display lists simultaneously. 

De Re ATARI has something to say about fine scrolling, but you have to see it in action to 
really learn how to use it. SCROLL is in this manual because you have to understand the 
technique before you can apply your maps to other applications. I hope it becomes a little 
clearer to those of you who choose to delve more deeply into your computer's capabili- 
ties. 
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SCROLL is an integral part of a program called 
MAPMAKER ♦ It provides the capability to fine 
scroll a multi-screen display* 

SCROLL operates under either Keyboard or 
joystick control* It takes the joystick value 
(or the Keyboard arrow Key v a 1 u e converted to 
its equivalent joystick value) and interprets 
that value into display movement actions* F i n e 
scrolling is a combination of incrementing the 
fine scroll registers and adjusting the LMS 
(Load Memory Scan) addresses in the display 
list to accomplish a coarse scroll each time 
the fine scroll register wraps around its 
m a x i m u m v a 1 u e ♦ 

The lines preceding label EXIT establish that the 
conditions for scrolling are met* They take the 
joystick value (or the converted Key value) i n t o 
the actual scrolling routines which follow* 

Four essentially similar sections accomplish the 
scrolling* Each section directs scrolling in a pri- 
mary direction* 

SCROLL is a vertical blank interrupt routine* It 
executes every vertical blank* Once loaded into RAM* 
it is enabled by a USR routine in MAPMAKER* 

To accomplish fast scrolling with the Keyboard* SCROLL 
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following System Vertical Blank routine decrements 
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MAPMAKER can disable scrolling in SCROLL by storing 
a 0 in location FLAG ♦ This is done during character 
entry and MENU mode* 

The following documentation completes the description 
of SCROLL ♦ 
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PAGE 6 VARIABLES 

MAX* HORIZ* COARSE SCROLL VALUE 
MAX* VERT ♦ COARSE SCROLL VALUE 
DISPLAY WIDTH FOR COARSE VERT ♦ SCROLL 
NEGATIVE OF INCRA IN TNOS COMP* 
START-STOP FLAG 

INDIRECT JUMP ADDRESS OF VBLANK ROUTINE 
CURRENT VALUE OF HORIZ* COARSE SCROLL 
CURRENT VALUE OF VERT* SCROLL 
PAGE ZERO VARIABLES 
DISPLAY LIST BASE ADDR ♦ 
SHADOWS HORIZ* FINE SCROLL REG* 
SHADOWS VERT* FINE SCROLL REG* 
HORIZ* FINE SCROLL REGISTER 
VERT* FINE SCROLL REGISTER 
STICK 0 REGISTER 
STICK 0 TRIGGER REGISTER 
SYSTEM TIMER FOR KEYBOARD DEBOUNCE 
LAST KEYBOARD CHAR* PRESSED 
DUMMY INIT* ADDRESS 
GET THE VALUE OF FLAG 
IF FALSE t EXIT SCROLL 
GET TRIGGER STATUS: 
IF TRUE > TEST FOR ARROW 
TRIGGER IS PUSHED: GET STICK VALUE 
STORE IT IN X 
IS THE STICK OFF CENTER? 
YES: GO TO SCROLL ROUTINE 
GET LAST KEY PRESSED 
STORE IT IN X 
TEST FOR SHIFT BIT ONLY 
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/ MM* 1 1 MM* 11 X I T W 1 1 MM W W «Al * » I W A 1 


602E 


8A 


1 1 20 

X X A— - 


TXA 




5 RETR I E U E 

/ 1 \ MM 1 I » M MM ▼ MM 


602F 

U V i. 1 


C90F 

Vrf vJ v 1 


1 1 30 

X X w V 


CMP 


*15 


; KEY UALUE 15 EQUATES TO STICK 

/ 1 \ MM 1 Til MM VmT MM X M» MM ~ W III MM W 1 MM* MM* 1 X MM* 1 \ 


603 1 

U V J i, 


D005 

LJ Vr - w 


1 140 

X X *•»* 


BNE 


BYE 


5 UALUE 13* IF EQUAL TO 15 t THEN 

/ Til Imm W mm X mm* ¥ XI mm ~ mm* 1 1 mm 1 mm X 1m / III mm ■ T 


6033 

VJ v w w 


A 9 0 D 


1 150 

X X \—' - 


LDA 


#13 


5 CONMERT TO 13 AND GO TO SCROLL 

/ MM W IT T MM 111 1 MM* M W 1 I I T MM* VJ W 1 W MM* MM 1 1 MM* MM MM 


6035 


AA 


1 160 

X X V— / - 


TAX 






6036 

v—/ \r w m/ 


D 0 0 C 


1 170 

XX/ *M* 


BNE 


SCRLK 




6038 

VJ V VJ VJ 


C906 

u u V U 


1 180 BYE 


CMP 


*6 


5IT NASN'T 15, IS IT 6^ IF NOT * THE KEY 

* «■» I r T 1 1 W IT I m 1m" ▼ «*- mm* «m | 1m/ m 1 IT 1m/ 1 * III mm ■ 1 mm 1 


603A 

vj v vj n 


DOOR 

LJ - - VJ 


1 190 

X X w %r 


BNE 


SCRLK 


5 VALUE IS THE SAME AS THE STICK MALUE 

/ Til MM W MM X 1m/ III MM MM* III! MM 1 1 MM* III MM MM* 1 M W/ 11 Til MM MM* MM 


G03C 

VJ - vJ w 


A90B 

1 I w V LJ 


1 2 0 0 


LDA 


*1 1 


5 CONVERT 6 TO 11 STICK UALUE 

/ mm 1m/ IT T Imm 11 I 1m/ 1 1m/ X X 1m/ I X mm* 11 Til mm 1m/ mm 


603E 

U V U L. 


AA 


1210 

X Aw X - 


TAX 




5 STORE IT 

r MM* 1 1m/ 1 1 Ml M 1 


603F 

U v U 1 


D003 

LJ - - W 


1220 

X A_ Am> V 


BNE 


SCRLK 


5SKIP A LINE 

r MM I 1 M> I II MM «M 1 » Im 


60^1 


60F506 


1230 EXIT 

X An U/ - Iamb / \ X 1 


JMP 


(UBLIN) 


5EXIT POINT FOR NO SCROLL 

» MM « » M 1 I Mf M IT 1 1 W 11 IT MAW MM* MM 1 1 MM* MA MM 


6044 


0980 

*•»' m/ mm* 


1240 SCRLK 


□ RA 


*$80 


50N AN ARROW SCROLL t SET BIT 7 

» MM* IT IIIT Illlll lM# r T MM MM 1 1 W MM MM • MM* MM 1 MT M 1 # 


6046 


AA 


1250 

X Am W - 


TAX 




5 STORE IT 

' MM* 1 MM* I 1 MM MB I 


6047 


D8 

LJ VJ 


1260 SCRL 

X A VJ - W \—l 1 \ tmm 


CLD 




5 SCROLL DISPLAY LEFT STARTS HERE 

/ MM* MM* 1 \ W MM MM MM* X V. 1 1 MM III MM MM 1 1 WV 1 1 1 1 1 1 MM* 1 1 MM 1 \ MM 


6048 

VJ - vj 


2908 

A— VmJ Vf • 


1270 

X Am / •» 


AND 


*8 


5 TEST FOR BIT 3 

• 1 MM MM 1 1 MM I 1 MM* M 1 W 


604A 


D031 

1— / - \mJ X 


1280 

X Am m/ - 


BNE 


NEXT2 


50N^ GO TO NEXT DIRECTION 

t MM 1 T Ml MT 1 Mf 1 T Imm « » I |M# M» 1 » Ml MM* I M» W 1 ■ 


604C 


A5CD 

1 1 %M* W Lb/ 


1290 

X Am m/ — 


LDA 


HSDAT 


;get current horiz* fine scroll malue 

/ mm Im I mm MM 1111 Imm 1 T 1 II mm 1 1 M> mmm T 1 A I T mm mm mm 1 1 mm Imm Imm Til mmm mm mm* 


604E 


290F 


1 3 0 0 

X W — V 


AND 


#$0F 


5 TEST BITS 0-3 

« 1 Imm W I MM A I MM m W 


6050 

vj - w - 


D023 

LJ - A— VJ 


1310 

X m/ X V 


BNE 


PASS1 


5ANY ON 7 FINE SCROLL ONLY 

* I I I T 1 mm IT* 1 M> 1 T Imm mm mm 1 1 mm !■ mm mm I T mm 1 


6052 

VJ V W * — 


ADF706 

1 1 LJ 1 / V VJ 


1 320 

X VJ A_ V 


LDA 


LINEOUT 


5 GET THE HORIZ, COARSE COUNTER 

/ WJ m 1 III m 1 1 m/ 1 1 X Am T 1m/ 1m/ 1 1 1 1 1m/ Imm 1m/ 1m/ 1m/ 1 T 1 Imm 1 1 


GO^S 

LJ *-* w' w 


CDF006 

V— / LJ 1 v V VJ 


1330 

X w w - 


CMP 


HLEN 


5 COMPARE TO HORIZ, COARSE LIMIT 

/ VMf 1m/ III III! MM 1 VmT 1 1 MM* 11 X MM V MM VmT 1 1 1 1 MM* MM MM X 1 1 X 1 


6058 

VJ - W' VJ 


F 0 2 3 

1 - Am* W 


1340 


BEQ 


NEXT2 


5 REACH LIMITS THEN DON'T SCROLL 

/II M 1 1 MM 1 1 MM mIImI III MM I T MM MM IT I MM 1m/ 1 1 MM MM MM 


605A 

w V w I 1 


A004 


1350 

X w/ w* - 


LDY 


#4 


5 BEG I N COARSli SCROLL ROUTINE 

/ m/ mm WJ X 1 T W 1m/ 1 1 1 1 1m/ Imm 1m/ 1m/ 1 1 1m/ mm mm 1 1 MM* MM* 1 X 1 T mm 


605C 

VJ V \ar \—i 


B 1 C3 


1360 L00P1 

X w/ M# — M— M/ m/ 1 X 


LDA 


( INDA) >Y 




605E 

VJ - w' L— 


18 

A 1m# 


1370 

X m/ / "•»" 


CLC 




5 THIS SECTION GETS THE LON BYTE 

• 1 II A mm MM* mm VmT 1 m VmT I T Mai mm 1 VmT III Mm* mm VmT r T m 1 I mm 


605F 


6902 

MM* Im/ - Am. 


1380 

X \n/ \m* •«•* 


ADC 


*2 


5 OF EACH LOAD MEMORY SCAN ADDRESS 

«* MM 1 MM 1 I MM 1 I MM* Mf I 1 MM 1 1 MM* 1 I W 11 I MM MM IIIT II M M 1 1 Ml MM W 


GOG 1 

VJ v VJ X 


9 1 CB 

vJ X w LJ 


1 390 

X W m/ 


STA 


( INDA) >Y 


5 IN THE DISPLAY LIST AND 

/ X 1 T III Im Im/ X 1m/ 1 Im> III mm X W 1 IIIT m/ 


G063 

VJ %/ VJ vJ 


C8 

W VJ 


1 400 


I NY 




5 ADS 2 TO IT* THEN STORES IT BACK 

/ II MM* Im/ mm 1 Im/ m 1 / III mm 1 T mm 1 Im/ 1 1 mm Im/ J* 1 Im/ 1 1 Im/ 1 1 


6064 


B 1 CB 

LJ X w LJ 


1410 


LDA 


( INDA ) »Y 

» w 9 9mmw « ■ * ■ ■ 


5 IN PLACE* THEN IT GETS THE HIGH 

9 *M 1 T 1 MM 1 1 MM* MM T III MM IT M 1 MS MM* 1 MM III MM 1 I M VJ 1 1 


6066 

VJ - VJ VJ 


6900 


1420 

X ~T Am — 


ADC 


no 


5 BYTE AND ADDS THE OVERFLOW t 

» MM 1 1 MM IIIT Im/ 1 I M*# MM MM* III MM MM T MM 111 Im* MM » « / 


R 0 R R 
vj yj vj o 


q 1 TR 


X 4 J v 


STA 


( INDA) t\ 


? IF ANY* WHY ^ BECAUSE FINE 

7 XI nillt mil a — Vr LunUUL 1 1 11 L 


606A 


C8 


1440 


I NY 




5 HORIZ* SCROLLING RANGES OUER 2 


606B 


C8 


1450 


I NY 




5 CHARACTERS IN LARGE TEXT MODE* 


606C 


C02B 


1460 


CPY 


#43 




606E 


D0EC 


1470 


BNE 


L00P1 


5 END OF COARSE SCROLL LOOP 


6070 


EEF706 


1480 


INC 


LINEOUT 


5 ADD 1 TO THE HORIZ* COUNT 


6073 


A5CD 


1490 


LDA 


HSDAT 


5 GET THE HSCROL UALUE 


6075 


18 


1500 PASS1 


CLC 






6076 


69FF 


1510 


ADC 


*$FF 


5 SUBTRACT 1 
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SCROLL . SRC ASSEMBLED AS SCROLL. OBJ 



G078 




1520 




♦ PAGE 




6078 


85CD 


1530 




STA 


HSDAT 




607A 


8D04DR 


1540 




STA 


HSCR0L 




G07D 


8A 


1550 


NEXT2 


TXA 






G07E 


2804 


1560 




AND 


**4 




6080 


D030 


1570 




BNE 


NEXT3 




6082 


A5CD 


1580 




LDA 


HSDAT 




6084 


280F 


1580 




a ki r\ 

AND 


*$0F 




6086 


C80F 


1600 




CMP 


**15 




6088 


D 0 2 0 


1610 




o kir 

BNE 


PASS2 




608A 


ADF706 


1620 




LDA 


LINE0UT 


608D 


F023 


1630 




O r— r-\ 

BEO 


NEXT3 




608F 


A004 


1640 




LDY 


*»4 




6081 


B1CB 


1650 


L00P2 


LDA 


( INDA) 


tY 


6083 


18 


1660 




CLC 






6084 


68FE 


1670 


• 


ADC 


*$FE 




6086 


81CB 


1680 




STA 


( INDA) 




6088 


C8 


1680 




I NY 






6083 


B1CB 


1700 




LDA 


( INDA) 


tY 


S08B 


E900 


1710 




r-\ o r** 

SBC 


no 




608D 


81CB 


1720 




STA 


( INDA) 


»Y 


608F 


C8 


1730 




I NY 






60A0 


C8 


1740 




I NY 






60 A 1 


C02B 


1750 




nnv/ 

C P Y 


**43 




60A3 


DOEC 


1760 




b kir 

BNE 


L00P2 




60A5 


CEF706 


1770 




DEC 


LINE0UT 


60A8 


A5CD 


1780 




LDA 


HSDAT 




60AA 


18 


1780 


PASS2 


CLC 






60AB 


6801 


1800 




ADC 


*1 




60AD 


85CD 


1810 




STA 


HSDAT 




60AF 


8D04D4 


1820 




STA 


HSCR0L 




60B2 


8A 


1830 


NEXT3 


"T \/ A 

TXA 






60B3 


2802 


1840 




Akin 

AND 


*2 




60B5 


D034 


1850 




our 

BNE 


NEXT4 




60B7 


A5CE 


1860 




1 P\ A 

LDA 


MSDAT 




60B8 


280F 


1870 




a k i r\ 

AND 


**$0F 




60BB 


C80F 


1880 




r* m o 

CnP 


*15 




60BD 


D024 


1830 




QUI — 

BNE 


PASS3 




60BF 


ADF806 


1800 




LDA 


PAGE0UT 


60C2 


CDF106 


1810 




i~\ lui n 

CMP 


ULEN 




60C5 


F024 


1820 




BEO 


NEXT4 




60C7 


A004 


1830 




LDY 


**4 




60C8 


B1CB 


1840 


L00P3 


LDA 


( INDA) 


»Y 


60CB 


18 


1850 




CLC 






60CC 


6DF206 


1860 




ADC 


INCRA 




60CF 


81CB 


1870 




STA 


( INDA) 


tY 


60D1 


C8 


1880 




I NY 






60D2 


B1CB 


1880 




LDA 


( INDA) 


tY 


60D4 


6 8 0 0 


2 0 0 0 




ADC 


**0 




60D6 


81CB 


20 1 0 




STA 


( INDA) 


fY 


60D8 


C8 


2020 




I NY 







5 STORE IT IN THE SHAD0N t AND IN 

5 THE H0RIZ. FINE SCROLL REG ♦ 

5N0N REPEAT THE PROCESS FOR BIT 2 

5 THIS SECTION MOVES THE DISPLAY RIGHT 



? MOVE THE DISPLAY UP HERE 



■ 
■ 



FOR UP-DOWN COARSE SCROLLING t 
ADD OR SUBTRACT THE SIZE 
OF THE DISPLAY N I DTH ♦ 
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SCROLL*SRC ASSEMBLED AS SCROLL.OBJ 



GODS 
SODS 
SODA 
BODC 
SODE 
SOE1 
S0E3 
S0E4 
SOES 
S0E8 
SOEB 
BOEC 
SOEE 
BOFO 
S0F2 
S0F4 
SOFS 
SOFS 
BOFB 
SOFD 
SOFF 
SI 00 
S103 
SI 05 
SI OS 
SI 08 
SI OA 
S10C 
S10D 
S10E 
SI 10 
6112 
SI 15 
SI 17 
SI 18 
SUA 

sue 

SUF 
S120 
S122 
S124 
S127 
S128 
S12B 



C8 

C02B 

DOEB 

EEF80B 

A5CE 

18 

S801 
85CE 
8D05D4 
8A 

2901 

D02F 

A5CE 

290F 

D021 

ADF80S 

F024 

A004 

B1CB 

18 

BDF30S 

91CB 

C8 

B1CB 

E900 

91CB 

C8 

C8 

C02B 

DOEB 

CEF80S 

A5CE 

18 

S9FF 
85CE 
8D05D4 
8A 

1005 
A901 
8D2B02 
F8 

SCF50B 



2030 
2040 
2050 
2 0 S 0 
2070 
2080 
2090 
2 1 00 
2110 
2120 
2130 
2140 
2150 
2 ISO 
2170 
2180 
2190 
2200 
2210 
2220 
2230 
2240 
2250 
22S0 
2270 
2280 
2290 
2300 
2310 
2320 
2330 
2340 
2350 
23B0 
2370 
2380 
2390 
2400 
2410 
2420 
2430 
2440 
2450 
24S0 



♦ PAGE 
I NY 



CPY #43 
BNE L00P3 
INC PAGEOUT 
LDA USDAT 

PASS3 CLC 

ADC #1 
STA VSDAT 
STA VSCROL 

NEXT4 TXA 

AND #1 
BNE EXIT2 
LDA USDAT 
AND *$0F 
BNE PASS4 
LDA PAGEOUT 
BEO EXIT2 
LDY #4 

L00P4 LDA ( INDA) >Y 
CLC 

ADC DECRA 
STA ( INDA) ,Y 
I NY 

LDA ( INDA) »-Y 
SBC #0 

STA ( INDA) >Y 
I NY 
I NY 

CPY *43 
BNE L00P4 
DEC PAGEOUT 
LDA USDAT 

PASS4 CLC 

ADC *$FF 
STA USDAT 
STA USCROL 

EXIT2 TXA 

BPL EXIT3 
LDA *$01 
STA SRTIMR 

EXIT3 SED 

JMP (MBLIN) 
♦ END 



5M0UE THE DISPLAY DONN HERE 



5 GET THE UALUE ONE MORE TIME 

5IF A STICK SCROLL, GET OUT 

50N A KEYBOARD SCROLL* NE WANT TO 

5 DISABLE DEBOUNCE* THIS DOES IT* 

5 RESET THE DECIMAL FLAG FOR BASIC 
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FILENAME: ALLPRPS ♦ SET ( ♦ SET ) ( ♦ FNT ) 



REG 1 REG 



REG 3 REG 4 



REG 1 REG 



2 



REG 3 REG 4 



__BLANK__ 
WNS RK'ER 
NS RIVER- 
NW RIUER- 
NNE RIUER 
SW RIUER- 
NSE RIMER 
EN RU'ER_ 
WSE RK'ER 
WNE RK'ER 

FILI 

_R MOUTH- 
LG R I UER- 
L-S RK'ER 
-FACTORY^ 
--TONER-- 
LT CASTLE 
RT CASTLE 

--FLAG 

SNAST I K A- 
MLT CROSS 

--STAR 

LT BSHIP- 
CT BSHIP- 
RT BSHIP- 
HILO TREE 
LOHI TREE 
-LG TREE- 
HILO MNT- 
LOHI MNT- 
LG MOUNT- 
-UOLCANO- 



SPACE 
i 

• 

it 

* 
$ 

% 

& 

/ 

( 
) 
# 
+ 
t 



/ 

0 

1 

2 
3 

-a 

5 
6 
7 
8 



■ 



> 
7 



C( t ) 

C( A) 

C(B) 

C(C) 

C(D) 

C(E) 

C(F) 

C(G) 

C(H) 

C ( I ) 

C( J) 

C(K ) 

C(L) 

C(M) 

C(N) 

C(O) 

C( P) 

C(O) 

C(R) 

C(S) 

C(T) 

C(U) 

C ( V ) 

C(N) 

C ( X) 

C ( Y ) 

C(Z) 

ESC 

C( - ) 

C( = ) 

C( + ) 

C(*) 



RETURN 
SH DEL 
SH INS 
C ( TAB ) 
SH TAB 



_-CITY_- ! 
-N COAST- 
-N COAST- 
_N COAST- 
NE COAST- 
NE COAST- 
-E COAST- 
-E COAST- 
-E COAST- 
SE COAST- 
SE COAST- 
-S COAST- 
-S COAST- 
_S COAST- 
SN COAST- 
SN COAST- 
-N COAST- 
_N COAST- 
_N COAST- 
NN COAST- 
NN COAST- 
_LT SHIP- 
_RT SHIP- 
-LT TANK- 
-RT TANK- 
-CAMALRY- 
-SOLDIER- 
LG GRASS- 
LOHI GRAS 
HILO GRAS 

--LAKE 

--GEAR 



@ 
A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
0 
P 
0 
R 
S 
T 
U 
U 
N 
X 
Y 
Z 

c 
\ 
] 



C( • ) 
a 
b 
c 
d 
e 
f 
* 
h 
i 
j 

k 
1 

M 

n 
o 
p 

r 
s 
t 
u 

w 

X 
Y 
Z 

C( 5 ) 

i 
i 

SH( < ) 
BACK S 
TAB 



C(2) 
C ( DEL ) 
C( INS) 



NOTE: "C" means CONTROL (CTRL) KEY and (character) ♦ 

"SH" means SHIFT KEY and (character) ♦ 

"DEL" means DELETE KEY* 

"INS" means INSERT KEY. 

"REG" means COLOR REGISTER* 
LT=left CT = center RT=riaht LG=lar*e M T = m o u n t a i n 
"Riuer mouth" is a Nest Coast character 
"L-S Riuer" means lartfe-to-small conversion 



n 



it 



and 



n 



are meant to be a trio 
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FILENAME: ALLPRPS ♦ SET ( ♦ SET ) ( ♦ FNT ) 



REG 1 



REG 2 



REG 3 



REG a 



REG 1 



REG 2 



REG 3 



REG a 



NOTE: 



SPACE 


! C( t ) 


i 

• 


! C( A) 


ii 


! C(B) 


* 


! C(C) 


$ 


! C(D) 


X 


C ( E ) 


& 


C(F) 




C(G) 


( 


C(H) 


) 


C ( I ) 


* 


C< J) 


+ 


C(K ) 


t 


C(L) 


- 


C(M) 


♦ 


C(N) 


/ ! 


C(O) 


0 


C( P) 


1 


C(Q> 


2 


C(R) 


3 : 


C(S) 


a \ 


C(T) 




C ( U ) 


6 ! 


C ( V ) 


7 ! 


C(W) 


8 ! 


C ( X) 


9 ! 


C ( Y ) 


■ 
■ 


C(Z) 


■ 

1 


ESC 


< \ 


C( - ) 




C( = ) 


> ! 


C( + ) 


• 


C(*) 


"C" means 


"SH" means 


"INS" means 



RETURN 
SH DEL 
SH INS 
C ( TAB ) 
SH TAB 



@ 
A 
B 
C 
D 
E 
F 
G 
H 
I 
J 
K 
L 
M 
N 
□ 
P 
0 
R 
S 
T 
U 
V 
N 
X 
Y 
Z 
[ 
\ 
] 



C( • 
a 
b 
c 
d 
e 
f 

h 
l 
J 
K 
1 
m 
n 
o 
p 

r 
s 
t 

u 
u 

«A» 

K 
Y 
Z 

c( ; 



) 



) 



) 



SH( 
BACK S 
TAB 



C(2) 
C ( DEL ) 
C( INS) 



"DEL" means DELETE KEY. 



"REG" means COLOR REGISTER. 



Permission is sf ranted to copy this patfe only. 



Appendices 29 



ATARI 

PROGRAM 
EXCHANGE 

P.O. Box 3705 

Santa Clara, CA 95055 



Review Form 




We're interested in your experiences with APX programs 
and documentation, both favorable and unfavorable. 
Many of our authors are eager to improve their programs 
if they know what you want. And, of course, we want to 
know about any bugs that slipped by us, so that the 
author can fix them. We also want to know whether our 

1. Name and APX number of program. 



instructions are meeting your needs. You are our best 
source for suggesting improvements! Please help us by 
taking a moment to fill in this review sheet. Fold the sheet 
in thirds and seal it so that the address on the bottom of 
the back becomes the envelope front. Thank you for 
helping us! 



2. If you have problems using the program, please describe them here. 



3. What do you especially like about this program? 



4. What do you think the program's weaknesses are? 



5. How can the catalog description be more accurate or comprehensive? 



6. On a scale of 1 to 10, 1 being "poor" and 10 being "excellent", please rate the following aspects of this program: 
Easy to use 

User-oriented (e.g., menus, prompts, clear language) 

Enjoyable 

Self-instructive 

Useful (non-game programs) 

Imaginative graphics and sound 



7. Describe any technical errors you found in the user instructions (please give page numbers). 



8. What did you especially like about the user instructions? 



9. What revisions or additions would improve these instructions? 



10. On a scale of 1 to 10, 1 representing "poor" and 10 representing "excellent", how would you rate the user 
instructions and why? 



11. Other comments about the program or user instructions: 



From 



STAMP 



ATARI Program Exchange 

P.O. Box 3705 

Santa Clara, CA 95055 



[seal here] 



MAPMAKER 

by Stephen W. Hall 

Recommended forages 13 and up/ Written in BASIC and 
machine language 

• Create multiscreen maps using color, fine-scrolling, and rede- 
fined character sets 

• Fit large maps into small amounts of memory 

• Experiment easily with design elements anywhere in your dis- 
play area 

• Use the all-purpose, map element character set included— or 
your own character set 

• Store completed maps on diskette 

Were you impressed by the beautiful map used in Chris Crawford's 
Eastern Front? Would you like to create maps as large and detailed 
as his? Whether you design computerized simulation games or are 
simply interested in getting the most from your ATARI Home 
Computer, you'll find Mapmaker a great programming tool. This 
easy-to-use utility can help you create multiscreen displays that 
capitalize on the ATARI Computer's outstanding multicolor, fine- 
scrolled redefined character sets. The large display that can fit in a 
small amount of memory is truly impressive. On systems with at 
least 40K of memory, Mapmaker makes up to 8K available for 
displays comprising as many as 34 screens! On a system with 32K of 
memory, 4K is available for screen displays of up to 17 screens. 

To create a map with Mapmaker, you first define the dimensions of 
the total display area, and then enter characters from the computer 
keyboard. Mapmaker acts as an easel upon which you can try out 
different combinations of shapes by displaying them on the screen. 
The program's fine scrolling feature allows smooth movement from 
one part of your map to another using either a Joystick Controller or 
the directional arrow keys on the computer keyboard. 



STEPHEN HALL 




About the author 



The idea for Mapmaker was born when 
Stephen Hall, of Arlington, Virginia, met 
Chris Crawford, author of APX's award- 
winning Eastern Front, at an ATARI 
users' seminar. As a war games en- 
thusiast, Stephen was fascinated by the 
game's intricate screen display. He 
reasoned that anyone who was going to 
create war games would need a good utility— and in writing one, 
Stephen could learn the technique for himself. His hobby has led 
him to a new career as a program developer for a software retailer. 
As computer games editor for Fire and Movement, a war games 
magazine, Stephen also writes regular reviews (including one 
praising Eastern Front as a ground-breaking achievement). 
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Mapmaker comes with an all-purpose character set of map 
elements, which are illustrated by the sample eight-screen map 
included on the diskette. However, you can use a separate character 
set editor to create your own mapping characters and then produce 
an infinite variety of displays with Mapmaker. A compatible editor is 
Instedit, available through APX. Using graphics mode 2, Mapmaker 
supports four character colors, plus a background color, and the 
package contains an easy-to-use facility for changing the playfield 
color registers. When you complete a map, the program saves your 
file on diskette. 

REVIEW COMMENTS 

Chris Crawford is a user of Mapmaker. This program is easy to use, 
but be prepared to spend several sessions building your map. 
Mapmaker uses page 6 of memory and can't be used with another 
program occupying this area. 

The user manual is excellent. It contains detailed descriptions of 
redefined character techiques, and the fine scrolling routine is well 
documented. 
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Limited Warranty on Media and Hardware Accessories. Atari, Inc. ("Atari ") 
warrants to the original consumer purchaser that the media on which APX 
Computer Programs are recorded and any hardware accessories sold by APX 
shall be free from defects in material or workmanship for a period of thirty (30) 
days from the date of purchase. If you discover such a defect within the 30-day 
period, call APX for a return authorization number, and then return the product 
to APXalong with proof of purchase date. We will repair or replace the product 
at our option. If you ship an APX product for in-warranty service, we suggest 
you package it securely with the problem indicated in writing and insure it for 
value, as Atari assumes no liability for loss or damage incurred during 
shipment. 

This warranty shall not apply if the APX product has been damaged by 
accident, unreasonable use, use with any non-ATARI products, unauthorized 
service, or by other causes unrelated to defective materials or workmanship. 

Any applicable implied warranties, including warranties of merchantability 
and fitness for a particular purpose, are also limited to thirty (30) days from the 
date of purchase. Consequential or incidental damages resulting from a 
breach of any applicable express or implied warranties are hereby excluded. 

The provisions of the foregoing warranty are valid in the U.S. only. This 
warranty gives you specific legal rights and you may also have other rights 
which vary from state to state. Some states do not allow limitations on how long 
an implied warranty lasts, and/or do not allow the exclusion of incidental or 
consequential damages, so the above limitations and exclusions may not apply 
to you. 

Disclaimer of Warranty on APX Computer Programs. Most APX Computer 
Programs have been written by people not employed by Atari. The programs 
we select for APX offer something of value that we want to make available to 
ATARI Home Computer owners. In ordertoeconomically offerthese programs 
to the widest number of people, APX Computer Programs are not rigorously 
tested by Atari and are sold on an "as is" basis without warranty of any kind. 
Any statements concerning the capabilities or utility of APX Computer 
Programs are not to be construed as express or implied warranties. 

Atari shall have no liability or responsibility to the original consumer pur- 
chaser or any other person or entity with respect to any claim, loss, liability, or 
damage caused or alleged to be caused directly or indirectly by APX Computer 
Programs. This disclaimer includes, but is not limited to, any interruption of 
services, loss of business or anticipatory profits, and/or incidental or conse- 
quential damages resulting from the purchase, use, or operation of APX 
Computer Programs. 

Some states do not allow the limitation or exclusion of implied warranties or 
of incidental or consequential damages, so the above limitations or exclusions 
concerning APX Computer Programs may not apply to you. 



For the complete list of current 
APX programs, ask your ATARI retailer 
for the APX Product Catalog 
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Duplicating the files onto another diskette 

Mapmakens disk-based, and uses or creates four separate diskette files in the process 
of creating a screen display. For this reason, you need to copy the files 
MAPMAKER.BAS and SCROLL.OBJ onto another diskette before using the program. 
First-time users should duplicate the entire diskette to transfer the character set file 
(ALLPRPS.SET) and the demonstration file (DEMO. MAP) along with the program files. 

Loading Mapmaker into computer memory 

1 . Insert the ATARI BASIC Language Cartridge in the cartridge slot of your computer. 

2. If you plan to use the Joystick Controller, plug it into the first controller jack of 
your computer console. 

3. Turn on your disk drive. 

4. When the BUSY light goes out, open the disk drive door and insert the Mapmaker 
diskette with the label in the lower right-hand corner nearest to you. 

5. Turn on your computer and your TV set. 

6. When the READY prompt displays on your TV screen, type 

RUN " D : MAPMAKER ♦ BAS " 

and press the RETURN key. The screen will clear, and then the message 

PROGRAM INITIALIZATION 

displays. The computer will access the diskette several times. 

7. If this is your first look at Mapmaker, no messages relating to character set files will 
display. Later, when you have more than one character set file on diskette, the 
program will ask you which character set you want to load. When only one character 
set is on the diskette, the program loads it automatically. 

8. Then the prompt 

Create a new map* or 
Load an existing map? 

displays. Type C to create a new map or L to load an existing one into memory. 

(Note. If you're a new user of Mapmaker, go to the next section, titled "Demonstrating 
Mapmaker", at this point.) 
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